home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / c / ctusr2.c < prev    next >
Encoding:
C/C++ Source or Header  |  1993-01-19  |  17.4 KB  |  593 lines
  1. /*  C K U S R 2  --  "User Interface" STRINGS module for CTOS-Kermit  */
  2. /* Modifications-Joel Dunn, UNC-CH, 9/21/87 clean up, make sure -h pauses */
  3. /*            -Doug Drury ITT-FSC, 6/91 added messages for added commands */
  4.  
  5. /*  This module separates long strings from the body of the ckuser module. */  
  6.  
  7. #include "ctermi.h"
  8. #include "ctcmd.h"
  9. #include "ctuser.h"
  10.  
  11. extern char cmdbuf[];
  12. extern int nrmt, nprm, dfloc;
  13. extern char *dftty;
  14. extern struct keytab prmtab[];
  15. extern struct keytab remcmd[];
  16.  
  17. static
  18. char *hlp1[] = {"\377PN\n\
  19.   Usage: kermit [-x arg [-x arg]...[-yyy]..]]\n\
  20.    x is an option that requires an argument, y an option with no argument:\n\
  21.      actions (* options also require -l and -b) --\n\
  22.        -O commands  perform commands after -O\n\
  23.        -s file   send \n\
  24.        -r           receive\n\
  25.        -k           receive to stdout\n\
  26.      * -g file   get remote file from server (wildcards not allowed)\n\
  27.        -a name      alternate name, used with -s, -r, -g\n\
  28.        -x           enter server mode\n\
  29.      * -f           finish remote server\n\
  30.      * -c           connect before transaction\n\
  31.      * -n           connect after transaction\n\
  32.        -h           help - print this message\n\
  33.      settings --\n\
  34.        -l line      communication line device\n\
  35.        -b baud      line speed, e.g. 1200\n\
  36.        -i           binary file\n\
  37.        -p x         parity, x is one of e,o,m,s,n\n\
  38.        -t           line turnaround handshake = xon, half duplex\n\
  39.        -w           don't write over preexisting files\n\
  40.        -q             be quiet during file transfer\n\
  41.        -d            log debugging info to debug.log\n\
  42.  *** for an action or setting that has 2 parts, use 2 CTOS parameters ***\n\
  43.  If no action command is included, enter interactive dialog.\n\
  44. \n\
  45. \n\
  46. \n\
  47. \n\
  48. \n\
  49. \n\
  50. \n\
  51. \n\
  52. \n\
  53. \n\
  54. \n\
  55. \n\
  56. \n\
  57. \n\
  58. \n\
  59. \n\
  60. \n\
  61. \n\
  62. \n\
  63. \n\
  64. \n\
  65. \n\
  66. \n\
  67. \n\
  68. \n",
  69. ""
  70. };
  71.  
  72. /*  U S A G E */
  73.  
  74. usage() {
  75.     conola(hlp1);
  76. }
  77.  
  78. /*  Help string definitions  */
  79.  
  80. static char *tophlp[] = { "\n\
  81. Type ? for a list of commands, type 'help x' for any command x.\n\
  82. While typing commands, use the following special characters:\n\n\
  83.  DELETE, BACKSPACE: Delete the most recent character typed.\n\
  84.  F3: Delete the most recent word typed.\n",
  85.  
  86. "\
  87.  F1: Delete the current line.\n\
  88.  RIGHT ARROW: Redisplay the current line.\n\
  89.  ?       (question mark) display help on the current command or field.\n\
  90.  RETURN      Attempt to complete the current field.\n",
  91.  
  92. "\
  93.  \\       (backslash) include the following character literally.\n\n\
  94. From command line, run ckermit.run, parm1 = -h to get help on command args.\
  95. \n",
  96. "" };
  97.  
  98. static char *hmxxask = "\
  99. Format: 'ask[q] \\\\%x prompt', where x is any letter (A-Z, a-z) and prompt\n\
  100. is any printable set of characters.  Issues the prompt and defines the\n\
  101. variable to be up to 20 non-control characters entered.  With askq, the\n\
  102. characters entered do not echo to the screen.";
  103.  
  104. static char *hmxxass = "\
  105. Format: 'assign \\\\%x text', where x is any letter (A-Z, a-z) and text\n\
  106. is any printable set of up to 20 characters.  Assigns the current value of\n\
  107. the text to the variable (macro).  The definition text is fully evaluated\n\
  108. before it is assigned, so that, the values of any referenced variables are\n\
  109. used, rather than their names.  Variables may not be used for keywords.";
  110.  
  111. static char *hmxxbye = "\
  112. Shut down and log out a remote Kermit server";
  113.  
  114. static char *hmxxclo = "\
  115. Close one of the following logs:\n\
  116.  session, transaction, packet, debugging -- 'help log' for further info.";
  117.  
  118. static char *hmxxcon = "\
  119. Connect to a remote system via the tty device given in the\n\
  120. most recent 'set line' command";
  121.  
  122. static char *hmxxget = "\
  123. Format: 'get filespec'.  Tell the remote Kermit server to send the named\n\
  124. files.  If filespec is omitted, then you are prompted for the remote and\n\
  125. local filenames separately.";
  126.  
  127. static char *hmxxlg[] = { "\
  128. Record information in a log file:\n\n\
  129.  debugging             Debugging information, to help track down\n\
  130.   (default debug.log)  bugs in the CTOS-Kermit program.\n\n\
  131.  packets               Kermit packets, to help track down protocol problems.\n\
  132.   (packet.log)\n\n\
  133.  session               Terminal session, during CONNECT command.\n\
  134.   (session.log)\n\n\
  135.  transactions          Names and statistics about files transferred.\n\
  136.   (transaction.log)",
  137. "" } ;
  138.  
  139. static char *hmxxlogi[] = { "\
  140. Syntax: script text\n\n\
  141. Login to a remote system using the text provided.  The login script\n\
  142. is intended to operate similarly to uucp \"L.sys\" entries.\n\
  143. A login script is a sequence of the form:\n\n\
  144.      expect send [expect send] . . .\n\n\
  145. where 'expect' is a prompt or message to be issued by the remote site, and\n\
  146. 'send' is the names, numbers, etc, to return.  The send may also be the\n\
  147. keyword EOT, to send control-d, or BREAK, to send a break.  Letters in\n\
  148. send may be prefixed by ~ to send special characters.  These are:\n\
  149. ~b backspace, ~s space, ~q '?', ~n linefeed, ~r return, ~c don\'t\n\
  150. append a return, and ~o[o[o]] for octal of a character.  As with some \n\
  151. uucp systems, sent strings are followed by ~r unless they end with ~c.\n\n\
  152. Only the last 7 characters in each expect are matched.  A null expect,\n\
  153. e.g. ~0 or two adjacent dashes, causes a short delay.  If you expect\n\
  154. that a sequence might not arrive, as with uucp, conditional sequences\n\
  155. may be expressed in the form:\n\n\
  156.      -send-expect[-send-expect[...]]\n\n\
  157. where dashed sequences are followed as long as previous expects fail.",
  158. "" };
  159.  
  160. static char *hmxxrc[] = { "\
  161. Format: 'receive [filespec]'.  Wait for a file to arrive from the other\n\
  162. Kermit, which must be given a 'send' command.  If the optional filespec is\n\
  163. given, the (first) incoming file will be stored under that name, otherwise\n\
  164. it will be stored under the name it arrives with.",
  165. "" } ;
  166.  
  167. static char *hmxxsen = "\
  168. Format: 'send file1 [file2]'.";
  169.  
  170. static char *hmxxser = "\
  171. Enter server mode on the currently selected line.  All further commands\n\
  172. will be taken in packet form from the other Kermit program.";
  173.  
  174. static char *hmhset = "\
  175. The 'set' command is used to establish various communication or file\n\
  176. parameters.  The 'show' command can be used to display the values of\n\
  177. 'set' parameters.  Help is available for each individual parameter;\n\
  178. type 'help set ?' to see what's available.\n";
  179.  
  180. static char *hmxychkt = "\
  181. Type of packet block check to be used for error detection, 1, 2, or 3.\n\
  182. Type 1 is standard, and catches most errors.  Types 2 and 3 specify more\n\
  183. rigorous checking, at the cost of higher overhead.  Not all Kermit programs\n\
  184. support types 2 and 3.\n";
  185.  
  186. static char *hmxyf[] = { "\
  187. set file: names, type, warning, display.\n\n\
  188. 'names' are normally 'converted', which means file names are converted\n\
  189. to 'common form' during transmission; 'literal' means use filenames\n\
  190. literally.\n",
  191.  
  192. "\n\
  193. 'type' is normally 'text', in which conversion is done between CTOS newlines\n\
  194. and CRLF line delimiters; 'binary' means to do no conversion.  Use 'binary'\n\
  195. for executable programs or binary data.\n",
  196.  
  197. "\n\
  198. 'warning' is 'on' or 'off', normally off.  When off, incoming files will\n\
  199. overwrite existing files of the same name.  When on, new names will be\n\
  200. given to incoming files whose names are the same as existing files.\n" ,
  201.  
  202. "\n\
  203. 'display' is normally 'on', causing file transfer progress to be displayed\n\
  204. on your screen when in local mode.\n",
  205. "" } ;
  206.  
  207. static char *hmhrmt[] = { "\
  208. The 'remote' command is used to send file management instructions to a\n\
  209. remote Kermit server.  There should already be a Kermit running in server\n\
  210. mode on the other end of the currently selected line.  Type 'remote ?' to\n",
  211.  
  212. "\
  213. see a list of available remote commands.  Type 'help remote x' to get\n\
  214. further information about a particular remote command 'x'.\n" ,
  215. ""} ;
  216.  
  217. /*  D O H L P  --  Give a help message  */
  218.  
  219. dohlp(xx) int xx; {
  220.     int x,y;
  221.  
  222.     if (xx < 0) return(xx);
  223.     switch (xx) {
  224.  
  225. case XXASS:                /* assign */
  226.     return(hmsg(hmxxass));
  227.  
  228. case XXASK:                /* ask, askq */
  229. case XXASKQ:
  230.     return(hmsg(hmxxask));
  231.  
  232. case XXBYE:
  233.     return(hmsg(hmxxbye));
  234.  
  235. case XXCLO:
  236.     return(hmsg(hmxxclo));
  237.  
  238. case XXCON:
  239.     return(hmsg(hmxxcon));
  240.  
  241. case XXCWD:
  242.     return(hmsg("\
  243. Change Working Directory, equivalent to CTOS path command...\n\
  244. String must be of form [vol]<directory>\n"));
  245.  
  246. case XXDEL:
  247.     return(hmsg("Delete a local file"));
  248.  
  249. case XXDIAL:
  250.     return(hmsg("Dial a number using modem autodialer"));
  251.  
  252. case XXDIR:
  253.     return(hmsg("Display a directory of local files"));
  254.  
  255. case XXECH:
  256.     return(hmsg("Display the rest of the command on the terminal,\n\
  257. useful in command files."));
  258.  
  259. case XXEXI:
  260. case XXQUI:
  261.     return(hmsg("Exit from the Kermit program, closing any open logs."));
  262.  
  263. case XXFIN:
  264.     return(hmsg("\
  265. Tell the remote Kermit server to shut down without logging out."));
  266.  
  267. case XXGET:
  268.     return(hmsg(hmxxget));
  269.  
  270. case XXHAN: 
  271.     return(hmsg("Cause the modem to hangup the telephone line."));
  272.  
  273. case XXHLP:
  274.     return(hmsga(tophlp));
  275.  
  276. case XXIF:
  277.    return(hmsg("\
  278. Syntax:  IF condition statement\n\
  279. Example: IF SUCCESS EXIT\n\
  280. Example: IF FAILURE GOTO LABEL1\n\
  281. Example: IF COUNT GOTO LABEL2\n\
  282. Example: IF EQUAL text1 text2 ECHO Strings are equal\n\
  283. Example: IF DEFINED variable_name ECHO The variable has been defined\n\
  284. Example: IF EXIST filename.ext ECHO The file exists\n\n\
  285. For SUCCESS and FAILURE, test the condition from the previously executed\n\
  286. Kermit statement and execute the statement following the condition.  For\n\
  287. COUNT, if the count value is greater than 1, decrement the count; if the\n\
  288. new count value is greater than zero, execute the statement following the\n\
  289. condition.  For EQUAL, if the two texts are lexically equal, execute the\n\
  290. statement following the condition.  If an IF statement contains\n\
  291. variables, they will be expanded before statement execution.\n\
  292. An astrisk may be used as a wild card in an IF EXIST file name."));
  293.  
  294. case XXINP:
  295.    return(hmsg("\
  296. Syntax:  INPUT n text\n\
  297. Example: INPUT 5 Login:\n\n\
  298. Wait up to n seconds for the given text to arrive on the communication line.\n\
  299. For use in script programs with IF FAILURE and IF SUCCESS.\n\
  300. Text may be up to 7 bytes."));
  301.  
  302. case XXRINP:
  303.     return(hmsg("Syntax: REINPUT n string\n\n\
  304. Look for the string in the text that has recently been INPUT, set SUCCESS\n\
  305. or FAILURE accordingly.  Timeout, n, must be specified but is ignored.\n\
  306. String may be up to 7 bytes."));
  307.  
  308. case XXLOG:
  309.     return(hmsga(hmxxlg));
  310.  
  311. case XXLOGI:
  312.     return(hmsga(hmxxlogi));
  313.  
  314. case XXOUT:
  315.     return(hmsg("Syntax: OUTPUT text\n\n\
  316. Send the text out the currently selected line, as if you had typed it\n\
  317. during CONNECT mode.  The text may contain backslash codes.  Example:\n\n\
  318.   OUTPUT help\\13"));
  319.  
  320. case XXPAU:
  321.     return(hmsg("Pause for a specified number of seconds."));
  322.  
  323. case XXREC:
  324.     return(hmsga(hmxxrc));
  325.  
  326. case XXREM:
  327.     if ((y = cmkey(remcmd,nrmt,"Remote command","")) == -2) return(y);
  328.     if (y == -1) return(y);
  329.     if (x = (cmcfm()) < 0) return(x);
  330.     return(dohrmt(y));
  331.  
  332. case XXSEN:
  333.     return(hmsg(hmxxsen));
  334.  
  335. case XXSER:
  336.     return(hmsg(hmxxser));
  337.  
  338. case XXSET:
  339.     if ((y = cmkey(prmtab,nprm,"Parameter","")) == -2) return(y);
  340.     if (y == -2) return(y);
  341.     if (x = (cmcfm()) < 0) return(x);
  342.     return(dohset(y));
  343.  
  344. case XXSHE:
  345.     return(hmsg("\nnot implemented\n"));
  346.  
  347. case XXSHO:
  348.     return(hmsg("\
  349. Display current values of 'set' parameters; 'show version' will display\n\
  350. program version information for each of the CTOS-Kermit modules;\n\
  351. 'show macros' will display the current values for all variables.\n"));
  352.  
  353. case XXSPA:
  354.     return(hmsg("Display space available on current volume\n"));
  355.  
  356. case XXSTA:
  357.     return(hmsg("Display statistics about most recent file transfer"));
  358.  
  359. case XXTAK:
  360.     return(hmsg("\
  361. Take Kermit commands from the named file.  Kermit command files may\n\
  362. themselves contain 'take' commands, up to a reasonable depth of nesting."));
  363.  
  364. default:
  365.     if (x = (cmcfm()) < 0) return(x);
  366.     printf("Not available yet - %s\n",cmdbuf);
  367.     break;
  368.     }
  369.     return(0);
  370. }
  371.  
  372. /*  H M S G  --  Get confirmation, then print the given message  */
  373.  
  374. hmsg(s) char *s; {
  375.     int x;
  376.     if (x = (cmcfm()) < 0) return(x);
  377.     printf("%s\n",s);
  378.     return(0);
  379. }
  380.  
  381. hmsga(s) char *s[]; {            /* Same function, but for arrays */
  382.     int x, i;
  383.     if ( x = (cmcfm()) < 0) return(x);
  384.     for ( i = 0; *s[i] ; i++ ) { puts(s[i]); fputc('\n', stdout); }
  385.     fputc( '\n', stdout);
  386.     return(0);
  387. }
  388.  
  389. /*  D O H S E T  --  Give help for SET command  */
  390.  
  391. dohset(xx) int xx; {
  392.     
  393.     if (xx == -3) {
  394.         printf(hmhset);
  395.         return(0);
  396.     }
  397.     if (xx < 0) return(xx);
  398.     switch (xx) {
  399.  
  400. case XYCHKT:
  401.     printf(hmxychkt);
  402.     return(0);
  403.  
  404. case XYCOUN:
  405.      printf("\
  406. Useful for implementing TAKE file loops.  Count is decremented each time\n\
  407. a loop is processed.\n");
  408.      return(0);
  409.  
  410. case XYDELA: 
  411.     printf("\
  412. Number of seconds to wait before sending first packet after 'send' command\n");
  413.     return(0);
  414.  
  415. case XYDUPL:
  416.     printf("\
  417. During 'connect': 'full' means remote host echoes, 'half' means this program\n\
  418. does its own echoing.\n");
  419.     return(0);
  420.  
  421. case XYEOL:
  422.     printf("\
  423. Decimal ASCII value for character to terminate outbound packets, normally\n\
  424. 13 (CR, carriage return).  Inbound packets are assumed to end with CR.\n");
  425.     return(0);
  426.  
  427. case XYESC:
  428.     printf("\
  429. Decimal ASCII value for escape character during 'connect', normally 27\n\
  430. ('GO')\n");
  431.     return(0);
  432.  
  433. case XYFILE:
  434.     printf(hmxyf[0]);
  435.     printf(hmxyf[1]);
  436.     printf(hmxyf[2]);
  437.     printf(hmxyf[3]);
  438.     return(0);
  439.  
  440. case XYFLOW:
  441.     printf("\
  442. Type of flow control to be used.  Choices are 'xon/xoff' and 'none'.\n\
  443. normally xon/xoff.\n");
  444.     return(0);
  445.  
  446. case XYHAND:
  447.     printf("\
  448. Decimal ASCII value for character to use for half duplex line turnaround\n\
  449. handshake.  Normally, handshaking is not done.\n");
  450.     return(0);
  451.  
  452. case XYLEN:
  453.     printf("\
  454. Packet length to use.  90 by default.  94 maximum.\n");
  455.     return(0);
  456.  
  457. case XYLINE:
  458.     printf("Device name of communication line to use.  Normally %s.\n",dftty);
  459.     if (!dfloc) {
  460.     printf("If you set the line to other than %s, then Kermit\n",dftty);
  461.     printf("\
  462. will be in 'local' mode; 'set line' will reset Kermit to remote mode.\n");
  463.     printf("\
  464. If the line has a modem, and if the modem-dialer is set to direct, this \n\
  465. command causes waiting for a carrier detect (e.g., on a hayes type modem). \n\
  466. This can be used to wait for incomming calls.  \n");
  467.     printf("\
  468. To use the modem to dial out, first set modem-dialer (e.g., to hayes), then \n\
  469. set line, next issue the dial command, and finally connect \n");
  470.     }
  471.     return(0);
  472.  
  473. case XYMARK:
  474.     printf("\
  475. Decimal ASCII value of character that marks the beginning of packets sent by\n\
  476. this program (normally 1 = Control-A)\n");
  477.     return(0);
  478.  
  479. case XYMODM:
  480.     printf("\
  481. Type of modem for dialing remote connections.  Needed to indicate modem can\n\
  482. be commanded to dial without \"carrier detect\" from modem.  Many recently\n\
  483. manufactured modems use \"hayes\" protocol.\n");
  484.     return(0);
  485.  
  486. case XYNPAD:
  487.     printf("\
  488. Number of padding characters to request for inbound packets, normally 0.\n");
  489.     return(0);
  490.  
  491. case XYPADC:
  492.     printf("Decimal ASCII value of inbound padding character, normally 0.\n");
  493.     return(0);
  494.  
  495. case XYPARI:
  496.     printf("\
  497. Parity to use during terminal connection and file transfer:\n\
  498. even, odd, mark, space, or none.  Normally none.\n");
  499.     return(0);
  500.  
  501. case XYPROM:
  502.     printf("Prompt string for this program, normally 'CTOS-Kermit>'.\n");
  503.     return(0);
  504.  
  505. case XYRETR:
  506.     printf("\
  507. Number of Retries to use during file transfers.\n");
  508.     return(0);
  509.  
  510. case XYSPEE:
  511.     printf("\
  512. Communication line speed for external tty line specified in most recent\n\
  513. 'set line'.  Any of the common baud rates up to 9600.\n");
  514.     return(0);
  515.  
  516. case XYTAKE:
  517.     printf("\
  518. Take file ECHO and ERROR on or off.  ECHO on causes display of Take File\n\
  519. progress messages.  ECHO off suppresses display of progress messages.\n\
  520. ERROR on causes Take File processing to abort when any error is encountered\n\
  521. ERROR off causes Take File processing to continue after an error is\n\
  522. encountered.  This is useful for implementing IF logic.\n");
  523.     return(0);
  524.  
  525. case XYTIMO:
  526.     printf("\
  527. Timeout interval for this program to use during file transfer, seconds.\n");
  528.     return(0);
  529.  
  530. case XYTERM:
  531.     printf("\
  532. Terminal type, options are 'none' and 'vt100'.\n");
  533.     return(0);
  534.  
  535. default:
  536.     printf("Not available yet - %s\n",cmdbuf);
  537.     return(0);
  538.     }
  539. }
  540.  
  541. /*  D O H R M T  --  Give help about REMOTE command  */
  542.  
  543. dohrmt(xx) int xx; {
  544.     int x;
  545.     if (xx == -3) {
  546.     printf(hmhrmt[0]);
  547.     printf(hmhrmt[1]);
  548.         return(0);
  549.     }
  550.     if (xx < 0) return(xx);
  551.     switch (xx) {
  552.  
  553. case XZCWD:
  554.     return(hmsg("\
  555. Ask remote Kermit server to change its working directory."));
  556.  
  557. case XZDEL:
  558.     return(hmsg("\
  559. Ask remote Kermit server to delete the named file(s)."));
  560.  
  561. case XZDIR:
  562.     return(hmsg("\
  563. Ask remote Kermit server to provide directory listing of the named file(s)."));
  564.  
  565. case XZHLP:
  566.     return(hmsg("\
  567. Ask remote Kermit server to tell you what services it provides."));
  568.  
  569. case XZHOS:
  570.     return(hmsg("\
  571. Send a command to the remote system in its own command language\n\
  572. through the remote Kermit server."));
  573.  
  574. case XZSPA:
  575.     return(hmsg("\
  576. Ask the remote Kermit server to tell you about its disk space."));
  577.  
  578. case XZTYP:
  579.     return(hmsg("\
  580. Ask the remote Kermit server to type the named file on your screen."));
  581.  
  582. case XZWHO:
  583.     return(hmsg("\
  584. Ask the remote Kermit server to list who's logged in, or to give information\n\
  585. about the specified user."));
  586.  
  587. default:
  588.     if (x = (cmcfm()) < 0) return(x);
  589.     printf("not working yet - %s\n",cmdbuf);
  590.     return(-2);
  591.     }
  592. }
  593.